DISKSCAN USER'S GUIDE 
by Dav i d Young 


* 

INTRODUCTION 

DISKSCAN is a powerful and flexible disk utility made to run with the ATARI 
810 disk drive. It is designed to include many features for advanced 
appl ications and yet be easy enough for a beginner to use. 

In a nutshell, DISKSCAN turns the computer's screen into a window looking 
directly onto the floppy disk. It transforms the mysterious bit patterns 
of the disk into whatever format is convenient for the application, be it 
HEX data, ASCII characters or even disassembled object code! While viewing 
a sector, it can be altered by positioning the cursor over the byte to 
be changed and then typing the change. Alternatively, a line assembler can be 
used to modify 6582 object files. A special directory feature reveals the 
starting sector of any file while a search function can be used to search 
any file, or even the whole disk, for a 1 or 2 byte sequence. Large groups of 
sectors can be imaged to another disk, transformed into a binary load file or 
even dumped to a printer. All of DISKSCAN's functions employ a user 
interface designed to anticipate responses and detect errors. 

Since DISKSCAN is menu driven, users already familiar with the 
structure of a disk can begin using the program immediately. At some point, 
however, it would be wise to read the detailed descriptions of the individual 

f mmands in order to become privy to their more subtle features. Those 

isiring to learn more about the disk should begin with the tutorial covering 
e different types of data structures to be found on the disk. This is not 
quite as scary as it sounds because there are not that many different types 
of data and the interactive use of DISKSCAN makes it all quite painless, 
even fun! Once the use of DISKSCAN is mastered it will become an 
indispensable tool to any programmer with a disk based ATARI PERSONAL 
COMPUTER . 

SYSTEM REQUIREMENTS 


ATARI 808/400 Personal Computer 
ATARI 810 Disk Drive 

24K RAM <32K for Assembler/Disassembler option) 
Printer (optional) 

GETTING STARTED 


NOTE: Before using this disk, back it up with option J of DOS. However, 

neither DISKSCAN program will start unless the original distribution 
disk is in drive 1. Should either program become unusable, make a fresh 
copy from the backup to the original disk. DO NOT REFORMAT THE ORIGINAL 
DISK! 




Turn on your disk drive and insert the DISKSCAN diskette. Insert 
BASIC cartridge and power up your computer. 

When the READY prompt displays, type RUN " DI SKSCAN . BI 6" for a 32K 
or RUN "DI SKSCAN. SML" for a 24K computer. 


the 


computer 


3. When the DISKSCAN menu appears, remove the DISKSCAN diskette and insert the 
diskette to be "scanned" into the drive. 
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THE MENU FUNCTION: M 


The first thing that appears on the screen when DISKSCAN is run is the 
menu. It consists of a list of letters which represent the primary functions 
available to you along with a short description of each function. In order 
to call up a function, you simply enter the letter which represents it when 
asked to do so. If you forget which function certain letters represent, 
then you can always return to the menu by using the "M" function. Since the 
function letters are supplied each time a function is requested, you will not 
find it necessary to return to the menu very often once you have gained a 
familiarity with DISKSCAN. 

Associated with the menu are three questions. Your answers to these 
questions let DISKSCAN know how the sectors of a file are related to each 
other <either sequentially or linked), how you would like the sector data to 
be represented on the screen (either in ATASCII characters or hexadecimal 
format), and in which drive the disk being scanned is. To change the sector 
mode, the screen format or the drive #, you can return to the menu with the "M" 
function. It is also possible (and more convenient) to change the screen 
format with the "T" (toggle screen format) function. If you are unsure 
how to answer these questions, it is highly recomended that you read the 
tutorial on disk data structures before proceeding. 

THE FUNCTION PROMPT 



To call up a DISKSCAN function, enter the letter which represents that 
ction when the following prompt appears on the screen: 


R,W,S,C,D,B, I ,X,A,T,G,P,H or M? 


This is referred to as the "function prompt". It consists of a list of the 
available functions followed by a question mark. Type the letter of the 
desired function but DO NOT follow it by RETURN. At this point a sector 
number may be requested. If so, supply the sector number either in decimal or 
hex (e.g., 20 or $14) and hit RETURN. The function will then be executed. If 
you cannot remember which letter corresponds to a certain function, use 
"M" to return to the menu. 
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INPUT FORMATS 


In the interest of user -friendliness, DISKSCAN will accept 
input in -four different formats: decimal, hexadecimal, character, and 
assembly language. Decimal and hex are val id anywhere a number is expected. 
Characters may be entered if DISKSCAN is in the character mode and you are 
using either the change <"C“> or scan <"S” ) functions. Assembly language is 
used in conjunction with the assembler function. 

To input a hex number, precede it with "$" . Thus, in response to "Sector 
#?" , you could enter either "$100" or "256" with the same result. The only 
exception to this rule is in the assembler, where most numerical operands 
MUST be specified in hex but need not be preceeded by "$" . The only 
assembler instructions that must have decimal operands are the 
conditional branches. The relative displacement MUST be specified as a 
decimal number preceded by “+" or The reason for these conventions is 

that the output of the disassembler, which conforms to the same rules, is 
limited to the right hand margin of the screen. This format actually turns ou 
to be quite convenient for most assembly language applications. 

RESPONDING WITH RETURN 


When DISKSCAN is awaiting your input, hitting RETURN preceded by no 
other characters is always a valid response. The program tries to 
interpret it in a manner convenient to you. For instance, when the function 
prompt appears, hitting RETURN will cause DISKSCAN to assume the previous 
function. In response to "Sector #?" , a RETURN will cause the program to 

t crement to the next sector if the command was the same, or i t wi 1 1 assume 
e same sector if the command just changed. Within certain contexts, 

RETURN causes the function to be aborted. 

If, for example, you would like to read quickly through several sectors, 
you would enter "R" in response to the function prompt and then supply the 
number of the first sector. From then on, if you enter only RETURNS in 
response to the function and sector prompts, DISKSCAN will continue to read 
the sectors of a file one after another. This is especially useful if 
the program is in linked mode as it will automatically calculate the next 
sector from the link at the end of the current sector. 

DIRECTORY OF THE DISK: D 

The directory function is useful for determining the location of a file 
on a DOS disk. (This function is only valid for disks with DOS formats.) It 
will read the 8 sectors of the directory one at a time and list the 
filenames of the directory entries along with with the file sizes and, 
most importantly, the starting sector of each file (all in decimal). It will 
stop after reading each sector and ask you if you have found the information 
that you needed. If you answer with anything other than “Y", it will read 
the next sector of the directory. If you answer with ”Y" or if there are no 
more directory entries, the function prompt will reappear awaiting your next 
command . 


To execute the directory function, type "D" when the 
^Ppears. The first sector of the directory will be reac 
i mme d i a t e 1 y . 


function prompt 
and d i sp 1 ayed 


READ SECTOR: R 


L J 


You will probably use this function of DISKSCAN more than any other. It 
reads an entire sector <128 bytes) from disk and displays its contents either 
in hex or as ATASCI I characters, depending on the current screen format. 

The 128 bytes are arranged on the screen in a matrix of 8 columns by 16 
rows. The address of the the first byte of each row is given in hex in the 
left margin. The sector number is provided at the top of the screen in 
both decimal and hex. 

To execute the read function type "R” when the function prompt appears. 
Then provide the sector number either in decimal or hex (preceded by "$"> and 
hit RETURN. The desired sector will be read and displayed immediately. The 
function prompt will then reappear awaiting your next input. 

TOGGLE SCREEN FORMAT: T 


This function is useful for changing the format of the screen output from 
hex to character or vice versa without having to return to the menu. In 
addition, it actually reprints the screen into the new format at the same 
time. Thus, if you were using the character format, you could type M T" to 
observe the sector link in hex and then flip back to character format by 
typing “T" again. 


To execute the screen 
ompt appears. 


toggle function, type 11 T" when the function 


PRINT SCREEN CONTENTS: P 


This function dumps the contents of the screen to the printer. It does not 
matter what is being displayed at the time except that, if the screen is in 
character format, certain characters are unprintable and are printed as 
dashes. Also note that inverse video characters are printed as normal 
characters. Thus, you can conveniently make a hard copy of sector data, the 
menu, or the disk directory. This is especially useful if you are going to 
alter a sector and you need a record of its original contents. 

To execute the screen dump function, type "P" when the function 
prompt appears. 

HEX CONVERSION: H 


The hex conversion function is a convenient way to convert hexadecimal 
numbers to decimal and vice versa. It will operate on any number from 0 to 
65535 ($0 to $FFFF) . If you use the assembler or disassembler much this 
function may come in handy. 

To execute the hex conversion function, type "H" when the function 
prompt appears. Then type the number to be converted and hit RETURN. 
Remember, always precede a hex number by . Both the decimal and 
hexadecimal form of the number will appear just above the function prompt 
fed will remain there until the execution of another function causes it 
be erased. 
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CHANGE CURRENT SECTOR: C 


The change sector -function is one of 
DISKSCAN and yet it is extremely easy to 
implemented, meaning you simply position 
byte of the sector and type the change. 


the most powerful features of 
use. A screen editor is 
the cursor over the desired 


This function is usually preceded by the "R" (read sector) function 
whereby a sector is read from disk into memory. When you use the change 
function you are really only altering the image of the sector in memory, not 
the actual disk sector. The sector on the disk will be updated only if you 
use the "W“ (write sector) function to copy the memory image back to disk. 


The cursor is positioned with the normal ATARI cursor control keys: 
CTRL-, CTRL=, CTRL+ , and CTRL* (the little arrows on these keys will not 
prir\t here). Notice that, when the cursor reaches the end of the line, it 
will automatically wrap to the beginning of the next line. Likewise, 
if you try to go below the last line of the sector it will wrap to the top. 
Thus, since the cursor starts in the top left corner of the sector, the 
easiest way to get to the end of the sector is to move the cursor to the 
left. You will probably have to try this out to see how it works. At any 
rate, it is impossible to move the cursor off of the sector matrix. 


When you have the cursor positioned over the byte you desire to change, 
type the new byte over the old. This will require 1 keystroke per byte when 

« e screen is in character format or 2 keystrokes per byte in the hex format, 
tice that the cursor automatically moves over as you type the change, 
us, you can alter any number of successive bytes without having to 
reposition the cursor. When in hex format, only valid hex characters are 
allowed. If you try to type any other characters, the sector buffer in memory 
will not be altered but the buzzer will sound and a blank will be left in that 
nybble position, indicating you need to go back and correct it. However, when 
in character format, ALL keystrokes print their ATASCI I representations 
except the cursor controls and ESC, which is used to exit the change 
function. Of course, BREAK is also not allowed unless you want to suspend 
execution of DISKSCAN. If you should accidently hit BREAK, clear the screen 
and type RUN. Your sector will still be in memory. 

To execute the change function, type "C" when the function prompt 
appears. Position the cursor and type the change. Exit the screen editor 
with ESC. Now write the sector back out to disk with the “W" (write sector) 
function if you desire to save it (see next section). 
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WRITE SECTOR TO DISK: W 


This -function is used to copy the sector image in memory to any sector on 
disk. Using it in conjunction with the change -function <"C"> or the assembler 
<"A"> allows you to alter disk data directly. This can be very convenient 
■for recovering an accidently erased -file, patching a boot disk and many 
other operations which cannot easily be performed through DOS. However, 
certain precautions should be taken to avoid loss of disk data integrity. 

First of all, always make a backup copy of the disk that you are going to 
alter. Secondly, it is a good idea to make a hard copy of a sector with the 
screen dump function <"P") before you alter it. 

Because the write function should not be used quite so casually as the 
other DISKSCAN functions, it is implemented so as to prevent accidental 
use. Before doing the write operation, the program will ask you if you are 
sure that you want to output to the specified sector number. You must 
answer with a "Y" and a RETURN for the write to take place. 

One short cut available to you when using this function (as well as others) 
is that you can usually just hit RETURN when "Sector #?" appears. This is 
because DISKSCAN will assume the same sector number if the write function was 
preceded by a different function (typically "C">. When the write 
function is preceded by itself, if, say, you are writing the same memory 
image to several sequentially numbered sectors, the program will automatically 

increment to the next sector. 

To execute the write function, type "W" when the function prompt appears 
^^d then provide a sector number (optional) followed by RETURN. The 
^Barren t sector in memor y will be displayed and you are pr omp ted to 
confirm your intent to write to the specified sector. A response other 
than "Y (RETURN)" will safely abort the operation. 
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SCAN DISK FOR 1 OR 2 BYTES: S 


One area where compu ters really sh ine is in their ab ility to quickly 
search a massive amount oF data For a speciFic sequence. The scan Function 
oF DISKSCAN will au tomat i cal 1 y search a disk For a 1 or 2 byte sequence which 
you speciFy. The scan sequence can be speciFied as numbers iF the screen is 
in hex Format or as characters iF in character Format. Once the search is 
underway , the progr am will s t op scanning the disk iF it encounters the 
speciFied sequence, display the sector, and ask you iF it has Found the right 
one. Any response other than "Y" will cause the search to resume where it was 
leFt oFF. It will stop scanning only iF the end oF File is encountered (iF 
in linked mode) or the end oF disk is reached <iF in sequential mode). 

You might now be asking the clever questions: "What happens iF the 2 bytes 

are split between the end oF one sector and the beginning oF another? And what 
about the sector links? Are they included in the search?" The answer 
is: Don't worry. DISKSCAN does the right thing in all cases. IF the First 
byte oF the sequence matches the last byte oF a sector and the second byte oF 
the sequence matches the First byte oF the next sector, the previous sector 
will be reread and d i sp 1 ayed . As to whe t her the sec t or 1 inks are i nc 1 uded 
in the search, it depends on the sector mode: in sequential mode the links are 

included, in linked mode they aren't. Analogous situations arise in both the 
assembler and disassembler Functions and they are handled just as 
expediently. 

» To execute the scan Function, type "S" when the Function prompt appears, 
en provide the sector number where the scan will begin and hit RETURN. 

SKSCAN will read and display the First sector and prompt you For the 
First byte oF the scan sequence. Type a number (not greater than 255 or $FF) 
or character, which ever is appropriate For the current screen Format, and hit 
RETURN. When prompted For the second byte, either supply it or just hit 
RETURN iF you want to search For a single byte. IF you want to speciFy a 
control character, be sure to precede it by ESC so that it will print instead 
oF execute. The RETURN character can be speciFied only with the screen in 
hex Format ($9B) . When the search starts, a visible counter ticks oFF the 
sector numbers as they are scanned. IF the sequence is Found, the sector will 
be displayed with a small arrow pointing to the First byte oF the 
sequence. IF you wish the scan to continue, hit any key but "Y" . While 
the scan is in progress, it can be aborted by hitting RETURN. 
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IMAGE SECTORS : I 


the 


« , This function is used to make an exact copy of one or more sequentially 
mbered sectors to another disk. The imaged sectors will retain their same 
numbers on the destination disk. While this function could be used to copy an 
entire disk, its main purpose is to allow you to easily keep your backup 
current as you modify a disk. In other words, at convenient points during 
modification of a disk you should make images of the sectors you have been 
working on to a secondary backup disk (not to the original backup). Of 
course , the read and write functions ("R" and “W“ > could just as easily be 
used if you only need to copy 1 or 2 sectors. 

The number of sectors you can image at one time is limited by the amount of 
free memory space available. Thus, the more RAM you have the better. However, 
there is another way to make more RAM available to the image function. If 
you have at least 32K of RAM then you will normally want to run DISKSCAN.BIG 
because it has the assembler/disassembler functions available. DISKSCAN.SML 
is the shorter implementation of DISKSCAN, made to run out of at least 24K. 
Thus, even if you have more than 24K of RAM, you may use DISKSCAN.SML to make 
available to the image function the maximum free memory space. This same 
discussion applies to the binary load file function ("B") as well. 

To execute the image function, type “I" when the function prompt appears. 

Su pp ly the starting sect or number an d hit RETURN . 'you will then be informed 
of the maximum number of sectors you can image at one time. Supply 
number of sectors you wish to image and hit RETURN. When prompted, 
destination disk and hit RETURN. When the function prompt appears, 
eration is complete and you may reinsert the source disk. 


the 

insert the 
the image 




BINARY LOAD FILE: B 


This function is used to make a binary load file out of one or more 
sectors. That is, you can make a DOS file out of the sectors of, say, a game 
boot disk. Then you can load the file into memory with the binary load option 
of DOS and perhaps disassemble it or even execute it. It will work in 
either sector mode, sequential or linked, but it will usually only make 
sense in the sequential mode. Though this is a very powerful function, it 
will be useful only to advanced users. 

The number of sectors you can make into a binary load file at one time is 
limited by the amount of free memory space available. Thus, the more RAM 
you have the better. However, there is another way to make more RAM available 
to the binary load file functi on • If you have at least 32K of RAM then you 

will normally want to run DISKSCAN.BIG because it has the 

assemb 1 e r/d i sassemb ler functi on s av a i 1 ab 1 e . D I SKSCAN . SML is the sh or ter 
implementation of DISKSCAN, made to run out of at least 24K. Thus, even if you 
have more than 24K of RAM, you may use DISKSCAN.SML to make available to the 
binary load file function the maximum free memory space. This same 
discussion applies to the image sectors function ("I") as well. 

To execute the binary load file function, type "B" when the function 
prompt appears. Supply the starting sector number and hit RETURN. You will 
then be informed of the maximum number of sectors you can make into a binary 

• ad file at one time. Supply the desired number of sectors and hit 

TURN. When prompted, insert the destination disk (make sure it is a DOS 

disk), supply the load address to be appended at the beginning of the file, 

and hit RETURN. When the function prompt appears, the binary load file is 
complete and you may reinsert the source disk. 


ASSEMBLY LANGUAGE SUPPORT 


Working in hex or character format is fine for many DISKSCAN appl i cat ions, 
but for inspecting and patching <6502 machine language files, assembly language 
support is almost a necessity. To this end, DISKSCAN not only offers an 
assembler and disassembler, but also a unique "GOTO binary address" function 
for locating specific addresses within a binary file. The assembly language 
facilities are only included in DISKSCAN. BIG for running on machines 
with at least 32K of RAM. There are several books on the market which cover 
6502 assembly language. One that I recommend is Beyond Games: Systems 
Software for Your 6502 personal computer by Ken Skier. 

DISASSEMBLE A SECTOR: X 


The disassembler function can translate the 6502 machine code of a 
binary file into standard assembly language instructions. It will 
disassemble, outputting to the right margin of the screen, from the point 
you specify within a sector until the end of the sector. If you desire, it 
will continue disassembling with the next logical sector, predicated on the 
current sector mode: sequential or linked. A multibyte instruction split 
between 2 sectors is handled gracefully with no discontinuity. Little arrows 
in the sector data matrix indicate the region of the sector being 
d i sassembl ed . 

The output of the disassembler is designed to fit into the limited space 

* 3 the right of the sector data matrix. For that reason, most numerical 
lerands are specified in hex, but without the preceding which usually 

istinguishes hexadecimal from decimal. The only disassembler instructions 
which have decimal operands are the conditional branches and these are 
always preceded by " +" or to indicate the direction of the relative 

displacement. To find the destination of the branch, start at the beginning 
of the next instruction and count forward or backwards the number of 

i 

bytes indicated by the displacement. 

Several other DISKSCAN -functions compliment the disassembler. If you 
need a hard copy o-f the disassembler output, use the “P" -function. A 
hexadecimal operand can be converted to decimal with the "H" function. If you 
need to find a specific address within a machine language program, use the "6" 
f unc t i on . 


To execute the disassembler function, type M X" when the function 
prompt appears. The current sector will be displayed and you will be 
prompted for the starting byte. Since the byte addresses are provided in hex 
to the left of the sector matrix, the starting byte is most easily provided 
in hex (preceded by "♦ M ). The disassembly will proceed from that 
point until the right margin is full. When the program asks if that is 
enough, any response other than "Y" will cause the disassembly to continue. 
This is also the case when the end of the sector is reached. Answering H Y" 
to the prompt will cause the disassembler to be terminated and the 
function prompt to appear. 
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ASSEMBLE INTO SECTOR : A 


When modifying 6502 machine language, a convenient alternative to 
the change function ("C") is the assembler function. It implements a 
line assembler (meaning that each instruction is assembled as you type it 
in) to modify the current sector in memory. It accepts standard 6502 
assembly language instructions and will beep at you if you attempt to input 
something illegal. You can start assembling anywhere within the sector 
(except within’the sector link if in linked mode). When the end of the 
sector is reached, if desired, the current sector will be written out and 
the next logical sector (predicated on the current sector mode: sequential or 
linked) will be read in. A multibyte instruction split between 2 sectors is 
handled gracefully with no loss of data. 

The numerical operands of the assembler conform to the same format as 
the disassembler. All numerical operands, except the displacements of 
conditional branches, must be given in hex and may or may not be preceded by 
»$« . The relative displacements of conditional branches must be specified 
in decimal preceded by M +" or to indicate the direction of the branch. 

To calculate this displacement, start at the first byte of the following 
instruction and count forward or backwards the number of bytes to the 
destination address. 

Should any question arise as to how to specify any of the 13 6502 
addressing modes, study the output of the disassembler . Leading zeros and 
hjibedded blanks are ignored by the assembler. 

To execute the assembler function, type "A" when the function prompt 
appears. Provide the starting byte (most conveniently in hex preceded by 
) and hit RETURN. You may then begin entering assembly language 
instructions followed by RETURN. Each instrucion will be translated into 
machine code and inserted into the sector buffer, overwriting the current 
contents. A little arrow in the sector matrix indicates the point at which the 
next instruction will be inserted into the sector. If the end of the sector 
is reached, you can cause the current sector to be written out and the next 
logical sector to be read in by responding to the prompt with "Y" . Any 
other response causes the assembler to be terminated. The assembler can also 
be terminated by hitting RETURN when prompted for the next instruction. 

Upon termination, the function prompt will reappear. 
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GOTO BINARY ADDRESS: G 



Inspecting a binary tile can be very tedious it the t 1 ow ot the program 
jumps around much. This is because it is very time consuming to calculate 
which byte ot which sector is referenced by an absolute address. In 
fact, if the task at hand is a large one, it is recommended that you use .he 
"B" function to create a binary load file out of the sectors of the program 
(unless, of course, it already is a binary load file with a convenient load 
address). This would allow you to load the program into memory for processing 
by a full blown disassembler. However, for casually inspecting a binary file, 
the GOTO function is a good way to find your way around. It allows you to jump 
to any absolute address within the file without doing a single calculation. 


When using the GOTO function, you can take advantage of the fact that the 
load address is usually located at the very beginning of a program. After you 
have specified this as the base address then the GOTO function can calculate 
the exact location on the disk of any absolute address within that program. 

It bases its calculation on either 125 by tes/sec tor , if the sectors are 
linked, or 128 by te s/sec tor , if they are sequential. Once the address is 
found, the disassembler < "X" ) can be executed starting at that location. 


To execute the GOTO function, type "G“ when the function prompt appears. 
Then provide the value, sector, and byte number of the base address as they 
ar e requested. If you h av e a 1 r e ady entered these on ce, just hit RE1 URN a t 
the first prompt. You will then provide the destination address. When 
vou hit RETURN, the program will go find the address, display the sector 
^^d print the byte number of the address above the function prompt so 
^iat it can be referenced when choosing the next function. Remember, if the 
base address remains the same, it is not necessary to specify it after the 
first use of the GOTO function. 


QUESTIONS? 

I have tried to make this program as powerful and user friendly as 
possible. I would appreciate any comments or suggestions. Also, if you have 
any questions, feel free to write. 

Dav i d Young 
421 Hanbee 
Richardson, TX 
75080 


